home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr51 / dbv121.zip / DBV.DOC < prev    next >
Text File  |  1993-04-01  |  6KB  |  163 lines
  1. DBV-DBF View, Version 1.21                             14-Jun-92
  2.  
  3.  
  4. Simple viewer for taking quick looks inside dBASE-compatible .DBF files in
  5. record and browse modes.  Does single-field, scan-across searches.  File
  6. header info, including field definitions, can be displayed either in
  7. interpreted (human-readable) format, or as hex bytes.  Editing of fields in
  8. both record and browse modes enabled by command-line switch.  New:  New
  9. searches automatically start from the first record.  The user may include
  10. default start-up switches in a configuration file.
  11.  
  12. Contents:
  13. =========
  14. Disclaimer
  15. Purpose
  16. Display
  17. Syntax
  18. Switches
  19. Configuration
  20. Commands
  21. Background
  22.  
  23. Disclaimer:
  24. ===========
  25. DBF View (DBV) and this documentation are offered as is.  The user bears the
  26. entire risk of this software not performing as expected.
  27.  
  28. Purpose:
  29. ========
  30. For taking quick looks into .DBF files without having to load a
  31. full-featured database program.
  32.  
  33. By user request, field editing has been incorporated into the program
  34. starting from Version 1.20.  Editing is enabled by command-line switch (see
  35. "Switches" below).
  36.  
  37. DBV is a generic .DBF file viewer/editor.  As there are different types of
  38. index files, these are ignored in searches and editing.
  39.  
  40. DBV is a free program.
  41.  
  42. Display:
  43. ========
  44. The program displays either in color or "black-and-white" based on the video
  45. mode at program start-up.  However, if the user has a color graphics card,
  46. but no color monitor, the display may be improved by using the DOS command
  47. "MODE BW80".  Conversely, color mode may be forced on by using "MODE CO80".
  48.  
  49. A command-line switch is also available to force black-and-white mode.  See
  50. "Switches" below.
  51.  
  52. EGA/43- and VGA/50-line modes are supported.  At program start-up, an
  53. attempt is made to detect the actual number of lines on the screen, up to a
  54. maximum of 50, and to adjust the display accordingly.
  55.  
  56. Syntax:
  57. =======
  58.  
  59.         Usage:  DBV [switches] [filespec]
  60.  
  61. If no extension is specified for "filespec", ".DBF" is assumed.  If a valid
  62. filename is specified unambiguously, the file is immediately displayed. 
  63. Either specifying "filespec" using wildcards, or specifying a drive or
  64. directory name causes a scrollable directory window to pop up.  Simply
  65. typing the program name is the same as specifying "*.DBF".
  66.  
  67.         Examples:       DBV C:          <- current directory of drive C:
  68.                         DBV D:\         <- root of drive D:
  69.                         DBV \DBASE\DATA <- data subdirectory of \DBASE
  70.  
  71. Switches:
  72. =========
  73. /BW     Black-and-White mode.  Provided as an alternative to using DOS's
  74.         "MODE BW80" command.
  75.  
  76. /E      enable field Edit.  Index files are ignored, and will have to be
  77.         maintained by the user.
  78.      
  79. /W      start program in Wide (browse) mode.
  80.  
  81. Either '/' or '-' may be used to specify switches.
  82.  
  83. Entering an invalid switch causes the program to display a brief help screen
  84. then exit.
  85.  
  86.         Examples:       DBV /h
  87.                         DBV -?
  88.  
  89. Configuration:
  90. ==============
  91. An optional configuration file containing user-selected default switches may
  92. be created or edited with any editor or word processor which can save pure
  93. ASCII text files.  This file should be named "DBV.CFG" and placed in the
  94. same directory from which DBV.EXE is loaded (DOS 3.0 and above).
  95.  
  96. Switches, including switch options, may either be separated by spaces or
  97. placed on separate lines.
  98.  
  99. A sample DBV.CFG file is included in the distribution archive for DBV. 
  100. After extracting the contents of the distribution archive, DBV.CFG may be
  101. deleted if DBV's defaults are satisfactory.
  102.  
  103. Commands:
  104. =========
  105. <F1>, or the letter 'I', will display overall information on the .DBF file. 
  106. Pressing <F1> a second time, or the letter 'H', will open up a window
  107. showing how this information is represented on disk as hex bytes.
  108.  
  109. <F2>, or the letter 'F', will display general information on each field. 
  110. Pressing <F2> a second time, or the letter 'H', will open up a window
  111. showing how this information is represented on disk as hex bytes.
  112.  
  113. <F3>, or the letter 'E', allows one to edit the current field.  This option
  114. is only available if the /E switch has been specified on the command line or
  115. included in DBV.CFG (see "Configuration" below).
  116.  
  117. <F4> will toggle between Browse and Record modes.
  118.  
  119. <F5>, or the letter 'G', opens up an input window into which you can type
  120. the (sequential) number of the record you wish to jump to.
  121.  
  122. <F7>, or the letter 'S', will allow a forward search for the input string. 
  123. This search is of the "scan-across" variety, i.e. the search will include
  124. embedded strings.  New searches start from the first record.  Subsequent
  125. searches on the same input string (by pressing <Enter> to accept the
  126. previous string) will start from after the current record.
  127.  
  128. <F10>, <Esc>, or the letter 'Q', will quit the program.
  129.  
  130. The <PgUp>, <PgDn>, <Home>, <End> and arrow-keys, possibly used in
  131. conjunction with the <Ctrl> key, will hopefully have the intuitive effects.
  132.  
  133. When in Browse mode, either <Tab> or <Right-Arrow> will move right one field
  134. at a time.  <Shift-Tab> and <Left-Arrow> will have the opposite effect.  The
  135. <Ctrl> key, used in combination with the left- and right- arrow keys will
  136. page left and right, respectively.
  137.  
  138. The letters 'P' (previous) and 'N' (next) are synonyms for the <PgUp> and
  139. <PgDn> keys, respectively.
  140.  
  141. Background:
  142. ===========
  143. I wrote DBV to test my understanding of .DBF file structure.  A pre-release
  144. version of DBV allowed field editing.  I disabled this feature before the
  145. first public release because I was inconvenienced by having to rebuild my
  146. multi-field index files with my regular database program, after editing with
  147. DBV.
  148.  
  149. A few users have requested that I add field editing to DBV.  They don't seem
  150. to mind having to maintain their own index files.  Although I would have
  151. preferred leaving DBV as a simple viewer, adding editing back was simple, as
  152. I already had the required routines at hand.  I've decided that, for now at
  153. least, editing would be enabled only by specifying the appropriate switch.
  154.  
  155. --
  156.  
  157.                 Raymond T. Kaya
  158.                 P. O. Box 1436
  159.                 Honolulu, HI  96806
  160.  
  161.                 CompuServe:  71230,2500
  162.                 GEnie     :  R.KAYA1
  163.